home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 1301_400 / DISK1393 / DISK1393.ZIP / CUDM31.EXE / lha / CUDM31.DOC < prev    next >
Text File  |  1990-01-11  |  45KB  |  1,062 lines
  1.   |
  2.   |   Colorado Utilities 
  3.   |     Disk Manager 
  4.   |       (CUDM)
  5.   |     Version 3.1
  6.   | 
  7.   | 
  8.   |   Copyright 1988, 1989
  9.   |
  10.   |   Micro System Solutions 
  11.   |
  12.   |   Author: Fred C. Hill
  13.   | A NOTE FROM THE AUTHOR
  14.  
  15. I have owned microcomputers of one brand or another since 1982, and 
  16. during that time have accumulated a great deal of software.  I also
  17. discovered the archive systems from SEA, PKWARE and others and have
  18. used these products to significantly reduce the number of diskettes
  19. required to store the thousands of files.  While the archive
  20. systems have reduced the cost of storing my collection of software
  21. and data, I have still managed to accumulate about 400 diskettes.
  22. The problem now is not "How do I store all this stuff?" but more
  23. like "Now that I have it, how do I find anything?".  To solve that
  24. problem I wrote CUDM, the Disk Manager.
  25.  
  26. CUDM will build a master catalog of all diskette and hard disk
  27. files, list them in alphabetical order, and tell me at a glance
  28. where my files are located.  CUDM will read compression libraries
  29. and include the individual files as well as the name of the library
  30. from which they came.  CUDM will also identify those files in the
  31. master catalog which have identical filenames (not necessarily
  32. duplicates). 
  33.  
  34. When I completed the first pre-release version of CUDM and used it
  35. to create my own master catalog I was shocked to find that almost
  36. 30% of my diskette storage was taken up by duplicate files,
  37. duplicate archives, and more than 5 backups of my MS-DOS diskettes. 
  38. It was great to be able to erase files instead of searching for
  39. diskette space to store them (which by the way CUDM will enable you
  40. to do).   
  41.  
  42. ASSOCIATION OF SHAREWARE PROFESSIONALS (ASP)
  43.  
  44. This program is produced by a member of the Association of
  45. Shareware Professionals (ASP).  ASP wants to make sure that the
  46. shareware principle works for you. If you are unable to resolve a
  47. shareware-related problem with an ASP member by contacting the
  48. member directly, ASP may be able to help. The ASP Ombudsman can
  49. help you resolve a dispute or problem with an ASP member, but does
  50. not provide technical support for members' products. Please write
  51. to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
  52. a Compuserve message via easyplex to ASP Ombudsman 70007,3536.  
  53. TECHNICAL SUPPORT
  54.  
  55. Technical support is available from:
  56.  
  57.       Micro System Solutions (MSS)
  58.       5417 S. Cimarron Road
  59.       Littleton, CO  80123
  60.  
  61.      Call:     1-(800) 421-1789 or (303) 795-7653
  62.       9 AM - 4 PM MST  Mon-Fri
  63.  
  64. The technical support line is available to those who have the fully
  65. registered version of CUDM.  As a registered user, you will be
  66. notified when updates to CUDM or new products are available.  You
  67. have received the latest version of CUDM and its documentation. 
  68. Anyone wishing to offer advice and suggestions is most welcome to
  69. do so.  Anyone having access to Compuserve can leave a message for
  70. MSS in either BPROGA or IBMSYS forum.  Our Compuserve PPN is 
  71. 76060,102.
  72.  
  73. DISCLAIMER
  74.  
  75. CUDM is provided on an `as is' basis.  Any damages arising from the
  76. use of this program are entirely the responsibility of the user. 
  77. Neither Micro System Solutions nor the author, Fred C. Hill, can
  78. be held responsible for any damages.
  79.  
  80. With respect to the physical diskette provided with the registered
  81. version, Micro System Solutions warrants the same to be free of
  82. defects in materials and workmanship for a period of 30 days from
  83. the date of purchase.  In the event of notification within the
  84. warranty period of defects in material or workmanship, MSS will
  85. replace the defective diskette.  Please call to obtain a return
  86. authorization prior to returning your diskette.  The remedy for
  87. breach of this warranty shall be limited to replacement and shall
  88. not encompass any other damages, including but not limited to loss
  89. of profit, and special, incidental, consequential, or other similar
  90. claims.
  91.  
  92.        Thank you for using CUDM
  93. INTRODUCTION
  94.  
  95. The Colorado Utilities Disk Manager (CUDM) is designed to allow you
  96. to manage thousands of disk files from both diskettes and your hard
  97. disk.  It creates a master catalog of files, libraries, and volumes
  98. and allows you to add up to 60 bytes of comments per entry, if you
  99. so desire.  CUDM also provides you with the capability to catalog
  100. sub-directories.  You can label diskettes as you catalog them, and
  101. you can also print a diskette cover listing volume contents.  
  102.  
  103. With CUDM you will be able to locate any file on any diskette or
  104. hard disk in seconds.  You will be able to find and eliminate
  105. duplicate files across all types of disk storage and manage your
  106. free disk space to use fewer diskettes.  CUDM's Catalog Status
  107. Screen, visible during most operations, shows you such important
  108. facts as the number of volumes, libraries, and files in your
  109. catalog; how much space has been used and how much space is
  110. available across all your cataloged volumes.  
  111.  
  112. You can update previously cataloged entries or delete entries.  You
  113. can sort entries or change the way entries are listed.  You can
  114. even do string searches, wild card searches, or `sounds-like'
  115. searches to find specific entries.  You can finally get a handle
  116. on all those files!  
  117.  
  118. CUDM 3.1 offers two different versions, the difference being the
  119. number of catalog entries that can be recorded and managed.  First,
  120. any version allows you an unlimited number of catalogs.  However,
  121. you can only manage one at a time, and there is no cross-
  122. referencing among catalogs, although conversion programs are
  123. available.  CUDM-RM is the Regular Memory version and allows you
  124. to catalog over 4000 files.  CUDM-VM is the Virtual Memory version
  125. which manages up to 300,000 files per catalog.
  126.  
  127.         
  128. INSTALLING CUDM
  129.  
  130. CUDM has three files which must be available in the DOS path while
  131. CUDM is executing.  These files are 'CUDM.EXE', and CUDM.HLP, and
  132. CUDMCNTX.HLP. If internal help is not required the two 'HLP' files
  133. need not be present.
  134.  
  135. Create a subdirectory for CUDM and its files by entering "CD\cudm"
  136. and pressing the <Enter> key. You may call the subdirectory
  137. anything you wish. Move to the new subdirectory by entering
  138. "MD\cudm" and pressing the <Enter> key. Install CUDM by placing the
  139. distribution disk in the A: (or B:) drive and entering "A:CUDM31"
  140. and pressing the <Enter> key. CUDM will be installed in the new
  141. directory.  Once installed, you must change your path command to
  142. include the subdirectories CUDM is in or move the CUDM files to a
  143. subdirectory already in the DOS path. An optional procedure for
  144. execution would be to always execute CUDM from its own directory.
  145. STARTING CUDM 
  146.  
  147. CUDM is started from the DOS command line by the following:      
  148.  
  149.     C>CUDM [/2] [catalogfile] 
  150.  
  151.    -  /2 (optional) Causes CUDM to open all files in a DOS
  152.       2.x unshared mode. If you use DOS 2.x this option
  153.       is required.
  154.  
  155.    -  catalogfile (optional) is the name of the catalog
  156.       file to use.  If catalogfile is omitted, the system
  157.       will use the default catalog name ("CATALOG").
  158.  
  159. The first time you execute CUDM, you will be prompted to answer the
  160. following:
  161.  
  162.  *******************************
  163.  *  Catalog does not exist     *
  164.  *  Create [catalogfile]? [Y]  *
  165.  *******************************
  166.  
  167. If the catalogfile name is correct and you want to proceed with
  168. creating the catalog, hit <ENTER>, otherwise hit N to abort the
  169. start-up.  
  170.  
  171. DEFINING CATALOGS
  172.  
  173. The Regular Memory (RM) version of CUDM uses all available standard
  174. memory for its catalog files and cannot be modified by the user. 
  175. The Virtual Memory (VM) version uses less standard memory, but
  176. requires the user to set the estimated size of the catalogs prior
  177. to file creation.  CUDM-VM will show you a screen and allow you to
  178. change the three main file capacities as follows:
  179.  
  180.           range -   low ........      high   default
  181.      Volumes:        10 ........     5,000      500
  182.      Libraries:      10 ........    30,000    1,000
  183.      Files:          10 ........   300,000   10,000
  184.  
  185. Comment and subdirectory catalog sizes are derived from these three
  186. catalog sizes. Since comments are allowed on any entry in any of
  187. the three main catalogs, sufficient file space is allocated to
  188. store comments for all entries.  The subdirectory count estimates
  189. the unique subdirectory names found in the catalog and is
  190. calculated at 5 percent of the total number of file records.
  191.  
  192. The disk space required for a catalog is roughly equal to the
  193. estimated number of records times 64.  Neither of the CUDM versions
  194. makes any attempt to optimize disk usage. Before cataloging any
  195. diskette files, be sure to further define your catalog feature
  196. options discussed under MANAGING THE CATALOG.
  197. CUDM FILES
  198.  
  199. CUDM.EXE is the program file and is required for successful CUDM
  200. execution.  The two help files(CUDM.HLP and CUDMCNTX.HLP) are
  201. optional and if present will provide on-line help. When CUDM
  202. creates a master catalog the following files result:
  203.  
  204. catalog.DAF  - This file stores all file references.
  205.  
  206. catalog.DAL  - Stores the compression libraries.
  207.  
  208. catalog.DAV  - Stores the disk volumes names.
  209.  
  210. catalog.DAC  - Stores all comments.
  211.  
  212. catalog.DAD  - Stores the references to sub-directories.
  213.  
  214. CUDM allows you to create as many catalogs as you want.  For each
  215. catalog that you create, the five files listed above could result,
  216. depending upon the options you choose for your catalog and the
  217. types of files that you record.
  218.  
  219. CUDM.CFG     -  Created when you change any of the default printer
  220. setting and color settings for CUDM.
  221.  
  222. catalog.KEP  -  Created when you turn the keep file subsystem on. 
  223. It contains the names of the files and wildcards to include in the
  224. current catalog.
  225. CUDM STATUS SCREEN
  226.  
  227. When you start CUDM, you will be presented the CUDM Status Screen. 
  228. This screen will be visible during many of the operations, since
  229. CUDM uses pull-down menus.  The top line of the screen contains the
  230. Main Menu selections Catalog, List, Options, etc.  To make your
  231. selection, either place the cursor on the Menu selection and hit
  232. <ENTER> or enter the first letter of the item.  A short descriptor
  233. appears in the upper left corner and tells you what function is
  234. performed by the menu item on which the cursor is placed.  The LIST
  235. function is only accessible AFTER you have cataloged the first
  236. diskette.  The sections that follow in the manual will discuss the
  237. functions of each of the Main Menu selections. 
  238.  
  239. The Status Screen shows you the status of the Master Catalog that
  240. is listed in the lower right corner of the screen.  Catalog Drive,
  241. in the lower left corner, tells you from which drive CUDM is
  242. cataloging.  Below, each of the fields shown on the Status Screen
  243. is defined:
  244.  
  245. NUMBER OF VOLUMES   -  The total number of volumes (diskettes and
  246. hard disk) that you have entered into the catalog.  The next four
  247. items relate to the Number of Volumes and are found to the right
  248. of Number of Volumes on your screen.
  249.  
  250. Number Files        -   The total number of files contained on all
  251. the volumes.  For example, if you cataloged 10 volumes, each
  252. containing 10 files, this value would be 100.
  253.  
  254. Space Used -   The total amount of space used across  volumes to
  255. store the number of files shown.
  256.  
  257. Available  -   The total amount of unused or available space across
  258. the volumes shown.
  259.  
  260. Total      -   The total amount of space accounted for in the
  261. volumes shown.
  262.  
  263. DIRECTORIES         -   The number of directories (or sub-
  264. directories) that you have cataloged.  If you do not wish to record
  265. directories, you can turn that feature off (see Managing the
  266. Catalog) and the Status Screen will reflect a `disabled' status.
  267.  
  268. COMMENTS   -   The number of comments that you have entered for
  269. your catalog entries.  If you do not wish to record comments, you
  270. can turn this feature off (see System Default Options) and the
  271. Status Screen will reflect a `disabled' status.
  272.  
  273. LIBRARIES  -   The total number of compression libraries that you
  274. have entered into the catalog.  The next two items relate to
  275. Libraries and are found to the right of the Libraries heading.
  276. Number Files        -   The total number of files cataloged as a
  277. result of cataloging all the libraries shown.
  278. Space Used -   The total amount of actual space used by the library
  279. files on their volumes.
  280.  
  281. FILES      -   The total number of files entered in your catalog.
  282.  
  283. Space Used -   The total amount of space that is or would be used
  284. by the files shown.  For library files that are compressed, this
  285. total reflects the amount of space that those files would use if
  286. they were not compressed.
  287.  
  288. AVAILABLE Files     -   The total number of file entries that you
  289. can add to your catalog.  
  290.  
  291. Libraries  -    The number of library entries that still can be
  292. made in your catalog.
  293.  
  294. Volumes    -    The number of volume entries that still can be made
  295. in your catalog.
  296.  
  297. Total      -    The total number of entries that you can still make
  298. in your catalog. 
  299.  
  300. MEMORY AVAILABLE    -    The total amount of memory still remaining
  301. to accommodate system functions such as sorting.
  302.  
  303. As you add and manipulate catalog entries, these statistics will
  304. change.
  305. MANAGING THE CATALOG
  306.  
  307. When you select CATALOG from the Main Menu, you will see the
  308. following pull-down menu on your screen:
  309.  
  310.  ********************************
  311.  *  Add/Update                  *
  312.  *                              *
  313.  *  Disk Drive A:               *
  314.  *  Catalog Name:  CATALOG      *
  315.  *  Expand Libraries - On (Off) *
  316.  *  Turn Keep Files  - On (Off) *
  317.  *  Keep File List              *
  318.  *  SubDirectories   - On (Off) *
  319.  *  Enable Comments  - On (Off) *
  320.  *  Interface Messages          *
  321.  ********************************
  322.  
  323. CATALOG FEATURE OPTIONS
  324.  
  325. The lower items on the Catalog Menu show you the status of certain
  326. catalog feature options.  You can change these features by placing
  327. the cursor on the item and hitting <ENTER>.  Below are descriptions
  328. of each of the features:
  329.  
  330. Disk Drive -    This identifies the disk drive (floppy or hard)
  331. from which you will be loading your catalog entries.  The options
  332. are  A:  through  Z:.
  333.  
  334. Catalog Name:       -    This shows the name of your catalog.  If
  335. you have multiple catalogs, you can change to another catalog by
  336. hitting <ENTER> on this item.  CUDM will prompt you to enter the
  337. name of the catalog you wish to load.  When you have made an entry,
  338. CUDM will save your changes and then load the new catalog.
  339.  
  340. Expand Libraries    -    When this feature is ON, CUDM will
  341. decompress any libraries it finds and catalog the individual files
  342. as well as the library.  If the feature is OFF, only the library
  343. itself will be reflected as a file on the volume.
  344.  
  345. Turn Keep Files     -    This feature, when ON, will cause CUDM to 
  346. compare each of the filenames (including those from compressed
  347. libraries) against the Keep File List maintained with the next menu
  348. item.  Only those files which match will be included in the current
  349. catalog.
  350.  
  351. Keep File List      -    This selection will open the keep file
  352. list and allow you to add, change or delete the filenames or DOS
  353. wild cards in the list.  A filename (ex. TPEDIT.PAS) will only
  354. allow that file to be added, while a wild card (ex. TP*.PAS) will
  355. be expanded to 'TP??????.PAS' and will allow any file with an
  356. extension of PAS that begins with 'TP' to be added.  Up to 16
  357. entries may be maintained in the Keep File.
  358. SubDirectories      -    This feature, when ON, will cause Sub-
  359. Directories to be cataloged and maintained for files within the
  360. catalog.  If the feature is OFF, Sub-Directories will not be
  361. cataloged or referenced.
  362.  
  363. Enable Comments     -    This feature, when ON, allows you to enter
  364. up to 60 bytes of comments for any catalog entry. If the feature
  365. is OFF, you can not enter any comments, nor can you retrieve any
  366. previously entered comments.
  367.  
  368. Interface Messages  -    This feature allows you to turn off some
  369. of the prompts encountered while cataloging files. This will save
  370. time and for some is unnecessary repetition.  The selections are
  371. discussed below.
  372.  
  373. Request Name Chg    -    When this is YES, you will be prompted
  374. with the Volume Change Name screen, shown on page 13.  Set it to
  375. NO by hitting <ENTER>, and CUDM will bypass the prompt.
  376.  
  377. Request Disk Load   -    When this is YES, you will be prompted to
  378. enter a disk in drive A: (or whatever disk drive you have assigned)
  379. for each diskette as described in ADD/UPDATE CATALOG ENTRIES below. 
  380. You can set it to NO by hitting <ENTER>, and you will not receive
  381. the prompt.  If you are cataloging a hard drive this prompt will
  382. be suppressed automatically.
  383.  
  384. Save Each Disk      -    When this is YES, CUDM, after loading each
  385. disk, will sort the catalog entries and save the catalog to disk. 
  386. When you set it to NO, by hitting <ENTER>, CUDM will not sort and
  387. save the catalog entries until you reset the feature to YES or
  388. complete the catalog function and move to another function.
  389.  
  390. You should set these feature options prior to cataloging any files. 
  391. Some of these options may be changed from one session to the next,
  392. such as the disk drive, or expand libraries.  If you want to use
  393. sub-directories, that feature should be turned ON and remain ON
  394. through follow-on sessions.  If the feature is OFF, and your disks
  395. contain sub-directories, they will be ignored (however, the files
  396. will be cataloged).  When the feature is ON and your catalog
  397. contains sub-directories, when you subsequently turn the feature
  398. OFF, your cataloged sub-directories will not be accessed by CUDM. 
  399. If you do an update with sub-directories turned OFF, any sub-
  400. directories previously entered will be lost.  The same holds true
  401. with comments.
  402. ADD/UPDATE CATALOG ENTRIES
  403.  
  404. After you have set your catalog feature options, you are ready to
  405. build your catalog.  To add files to your catalog, place the cursor
  406. on Add/Update and hit <ENTER>.  If you are cataloging diskette
  407. files, you will be prompted to:     
  408.  
  409.    *****************************
  410.    *  PLACE A DISK IN DRIVE A: *
  411.    *****************************
  412.  
  413. Place the diskette you wish to catalog (or update) into your
  414. diskette drive and hit <ENTER>.  
  415.  
  416. If the volume has not been previously cataloged, the following
  417. message will appear:
  418.  
  419.    *****************************
  420.    *  Volume is [vol-name]     *
  421.    *  Change Name?  [N]        *
  422.    *****************************
  423.  
  424. If you do not wish to change the volume label, hit <ENTER> (or N)
  425. and the volume will be cataloged.  If you want to change the volume
  426. name, key Y and the following message will appear:
  427.  
  428.    *****************************
  429.    *  ENTER VOLUME NAME        *
  430.    *****************************
  431.  
  432. Key in the volume name and hit <ENTER>.
  433.  
  434. If the volume doesn't have a label, you will be asked to enter one. 
  435.  
  436. update it by presenting the following message:
  437.  
  438.    *****************************
  439.    * Volume  ARC_0001  exists  *
  440.     * Update?  [N]             *
  441.    *****************************
  442.  
  443. If you do NOT want to update, press <Enter>.  Otherwise type in Y
  444. and CUDM will add or change catalog information to reflect the
  445. current contents of the volume.  Files and libraries that have been
  446. removed from the disk since it was cataloged or last updated will
  447. be removed from the catalog as well.  If you have previously
  448. entered comments for any entry, the comments will be maintained
  449. after the update as long as the file/library continues to exist on
  450. the disk.
  451.  
  452. When you have finished cataloging your disk files, you can then
  453. view them by accessing the LIST Menu.   LISTING THE CATALOG
  454.  
  455. The LIST functions allow you to review and manipulate the catalog
  456. entries.  The full catalog list provides the following information
  457. for each file:
  458.  
  459.      o  Volume
  460.      o  Library.Ext
  461.      o  Filename.Ext
  462.      o  Size
  463.      o  Date (Last Updated)
  464.      o  Time (Last Updated)
  465.  
  466. When the above information is showing on the screen, CUDM places
  467. a "+" to the right of the catalog entry to indicate that a comment
  468. is present.  If you have enabled comments, they will appear on the
  469. screen in the rightmost 40 - 60 characters of the catalog entry and
  470. will overlay the Size, Date, and Time information.  When the
  471. comment exceeds the available screen characters, the information
  472. will scroll to the left, showing up to 40 characters.    We will
  473. discuss how to enter comments and manipulate catalog entries later.
  474.  
  475. In addition to the above information, CUDM will list a "d" to the
  476. right of any file record that is a duplicate file name.  You can
  477. change the information presented in the List by selecting the
  478. Parameters Option from the LIST Menu (discussed below).
  479.  
  480. When you select LIST, the following  Menu will appear:
  481.  
  482.    **************************
  483.    *  Entries               *
  484.    *  Duplicates            *
  485.    *  Volume Information    *
  486.    *  Imbedded Search       *
  487.    *  Soundex               *
  488.    *  Wild Card             *
  489.    *  Parameters            *
  490.    **************************
  491.  
  492. The Menu Options are discussed below:
  493.  
  494. Entries      -    This allows you to select the catalog list for
  495. Files, Libraries, or Volumes.  A Sub-Menu will be presented for
  496. you to make your list choice.
  497.  
  498. Duplicates   -    This allows you to list duplicate Files or
  499. Libraries.  A Sub-Menu will be presented for you to make your list
  500. choice.
  501. Volume Information  -    This allows you to list the volumes in
  502. your catalog.  When you make this selection, CUDM provides you with
  503. a list of the volume names in the catalog.  Select the volume you
  504. wish to view and CUDM will give you the following information about
  505. the volume:  Volume Name, Date Created, Capacity, Space Used,
  506. Freespace, Number of Files, and any Comment associated with the
  507. volume.  You will also be given a list of all the libraries and
  508. files contained on the volume.
  509.  
  510. Imbedded Search     -    This allows you to search the Files,
  511. Libraries, or Volumes entries for a specific string of characters. 
  512. After you select your entry type, you will be prompted to enter the
  513. scan mask.  CUDM will search the entry names for the string.
  514.  
  515. Soundex      -    This allows you to search the Files, Libraries,
  516. or Volumes entries for any name that  "sounds like" a name that you
  517. enter.   After you select your entry type, you will be prompted to
  518. enter the scan mask.  CUDM will search the entry names for anything
  519. that equals or sounds like the scan mask.  The search is done
  520. against the ENTIRE entry name - it does not do a partial name
  521. search.
  522.  
  523. Wild Card    -    This allows you to use the DOS wild card search
  524. technique against the Files, Libraries, or Volumes.  After you
  525. select your entry type, you will be prompted to enter a scan mask,
  526. e.g., *.BAS or FILEABC.*.  CUDM will search the entry names and
  527. return any matches.
  528.  
  529. Parameters   -    This allows you to control the information that
  530. is presented on the list.  When you select Parameters, you will be
  531. given the Sub-Menu shown below.
  532.  
  533. Parameters Menu:
  534.  
  535.    **************************
  536.    * File/ext Split  -  On  *
  537.    * Print Comments No      *
  538.    * List Library   Yes     *
  539.    *      Volume    Yes     *
  540.    *      Size      Yes     *
  541.    *      Time      Yes     *
  542.    *      Comment   No      *
  543.    *      Directory No      *
  544.    **************************
  545. The parameter options are as follows:
  546.  
  547. File/ext Split      -    When this feature is ON, file and library
  548. names will be aligned on the period.  For example, given two
  549. filenames, TEXT.EXT and TESTFILE.EXT   -     when the split feature
  550. is ON, the filenames  would list as:
  551.  
  552.     TEXT    .EXT
  553.     TESTFILE.EXT
  554.  
  555.     If the feature is OFF, they would list as:
  556.  
  557.     TEXT.EXT
  558.     TESTFILE.EXT
  559.  
  560. Print Comments      -    When this feature is ON, comments will
  561. print when a Print Selection is made.  Comments will print beneath
  562. the entry for which they have been made.  When the feature is OFF,
  563. the comments will not print.
  564.  
  565. List Library -    Setting any of these features ON will cause    
  566.  Volume       that particular column to be displayed on the    Size 
  567. list.  If the feature is OFF, the column will    Time  not show on
  568. the listing.
  569.  
  570. List Comment -    Setting this feature ON will cause the comments
  571. to be displayed in the rightmost 40 characters of an entry on the
  572. screen.  The comment will replace the Size and Time columns.  You
  573. will notice that when you turn Comment ON, Size and Time
  574. automatically are set to OFF.  When the List Comment feature is
  575. OFF, comments will not automatically show on the listing.  You can,
  576. however, use the "Show Comment"  feature discussed under
  577. Manipulating the List (see below).  This feature will not function
  578. if Comments are disabled (see Managing the Catalog).
  579.  
  580. List Directory      -    Setting this feature ON will cause the
  581. Sub-directory Name to be listed on the bottom line of the screen. 
  582. The name will change as you move the cursor to a new entry.  When
  583. the feature is OFF, the sub-directory name will not be displayed. 
  584. This feature will not function if Directories are disabled (see
  585. Managing the Catalog).
  586. MANIPULATING THE LIST
  587.  
  588. When you have selected your entries and defined the information for
  589. your list, you are then ready to manage the list or the catalog. 
  590. It is during this stage that you will add comments, identify
  591. duplicates, erase files from the catalog, and plan for reorganizing
  592. and optimizing your disk storage.  A number of options are
  593. available for you to manipulate the list to accomplish your goals. 
  594. When you are in a List, you can press F9 to get the following List
  595. Sub-Menu:
  596.  
  597.    *******************************
  598.    *  Hide (Show) Comments       *
  599.    *  Remove (Undo Remove) Entry *
  600.    *                             *
  601.    *  Print Selection            *
  602.    *  Compressed List            *
  603.    *  Diskette Cover             *
  604.    *  Labels                     *
  605.    *  Export Selection           *
  606.    *******************************
  607.  
  608. Each of these menu items is discussed under its appropriate
  609. operation on the following pages.  If the cursor will not highlight
  610. a particular option, that option is not applicable to the List
  611. currently displayed.  For example, Diskette Cover and Labels are
  612. only appropriate when listing Volumes.  When you are listing Files,
  613. you cannot select either of those options.
  614.  
  615. CURSOR MOVEMENT
  616.  
  617. When you are presented with a listing, whether it be one of
  618. volumes, archives, files, or a DOS directory, you may move about
  619. the list using the various cursor control keys on your keyboard. 
  620. They work as follows:   
  621.  
  622. Up Arrow  -  Moves the cursor (or highlighted line) up one line. 
  623.  If the cursor is already at the top of the screen   then entries
  624. will be scrolled down one line. (until   the first entry is
  625. displayed on the first line). 
  626.  
  627. Down Arrow     -    Moves the cursor (or highlighted line) down one 
  628.  line. If the cursor is already at the bottom of the   screen then
  629. entries will be scrolled up one line.   (until the last entry is
  630. displayed on the last   line). 
  631.  
  632. Page Up   -  Scrolls the displayed entries up one page of data.  
  633. On a standard mono or CGA screen this would be 18   lines. On an
  634. EGA screen it would be 37 lines.  Of   course the total data
  635. movement will depend on the   number of data entries in the
  636. catalog. 
  637. Page Down -  Scrolls the displayed entries down one page of data.
  638. This operation is the exact opposite of the page up command. 
  639.  
  640. Home      -  Returns the screen to the home or first page of  
  641. data. 
  642.  
  643. End       -  Displays the last page of data.  This assumes there 
  644.  is more than one page of data to be displayed. 
  645.  
  646. Ctrl-PgUp -  This key combination operates exactly like the Home 
  647.  key. 
  648.  
  649. Ctrl-PgDn -  This key combination operates exactly like the End  
  650. key. 
  651.  
  652. Esc       -  The <Esc> key will always cancel the current  
  653. operation and in most case back you out of the   operation.  Once
  654. you reach the inactive screen the   <Esc> key will return you to
  655. the main menu and back   to the inactive screen. 
  656.  
  657. USING A MOUSE
  658.  
  659. You can also use a mouse with CUDM.  If you have a mouse connected
  660. to your system, you will notice the mouse cursor on your screen. 
  661. To use the mouse, place the cursor on the menu item that you want
  662. to select and press the left button.  If you want to escape the
  663. menu, press the right button.  If you want to access the Help
  664. window for the particular function, press both buttons.  When you
  665. are in a list window, you can scroll through the list, forward or
  666. backward, by placing the cursor on the scroll bar to the right of
  667. your screen and pressing the left button.  If you place the cursor
  668. at the top of the line, you will move to the top entry in the list. 
  669. If you place the cursor in the middle of the line, you will move
  670. to a middle entry in the list.  If you place the cursor at the
  671. bottom of the line, you will move to the last entry in the list,
  672. and so on.  A scroll box will remain on the line to mark the place
  673. you last selected.
  674.  
  675. DELETING CATALOG ENTRIES
  676.  
  677. To delete an entry from the catalog (list), place the cursor on the
  678. entry and press the F5 function key.  You will notice that the
  679. entry line changes color (or shading if you have a monochrome
  680. monitor).  When you move the cursor off the deleted entry, the
  681. color will change again, so that you can always see the deleted
  682. entries.  If you wish to undo the delete, simply repeat the
  683. operation just described.  The selected entries will actually be
  684. deleted when you exit the LIST session.  If you delete a volume or
  685. library, the files on that volume or library are also deleted.  You
  686. can also delete/undelete an entry using the Remove Entry/Undo
  687. Remove.
  688. REMOVE/UNDO REMOVE
  689.  
  690. As mentioned above, you can delete an entry by placing the cursor
  691. bar on the entry, pressing F9, and selecting Remove Entry from the
  692. Menu shown on page 17.  When you press <ENTER>, the entry will
  693. change in color or shading to let you know that the entry is to be
  694. deleted.  If you wish to reverse your action, press F9 again and
  695. the menu will offer you the option to Undo Remove.  When you press
  696. <ENTER>, the entry will remain in the catalog.  
  697.  
  698. If you remove a library or volume, the files that make up that
  699. library or volume will also be removed.  If you undo a remove on
  700. a library or volume, all of the comprising files will be also be
  701. restored to the catalog. Even if you undo a remove for a single
  702. file on a removed volume, all files on the volume will be restored.
  703.  
  704. ADDING COMMENTS
  705.  
  706. If you have Enabled Comments (see Managing the Catalog, page 10),
  707. you can enter a comment for any or all entries.  To enter the
  708. comment, hit <ENTER> or function key F7, and you will see the
  709. comment area highlighted.  Key in your comment (up to 60
  710. characters) and hit <ENTER>.  If your comment is longer than the
  711. 40 characters on the screen, the comment will scroll to the left,
  712. allowing you to continue entering characters to the right.  If the
  713. comment field is not showing on your screen, you will see a "+" to
  714. the right of each entry which has a comment associated with it. 
  715. You can view the contents of any comment by hitting <ENTER> or F7. 
  716. To turn the comment off, just hit <ENTER> or F7 again.
  717.  
  718. COMMENT DISPLAY
  719.  
  720. The default mode for the display of comments is to HIDE them.  
  721. When the list is in the HIDE mode, you can look at an single
  722. entry's comment by placing the cursor bar on that entry and hitting
  723. <ENTER>.  Hitting <ENTER> again will turn the comment off.  If you
  724. wish to see the comments for the entire list, press F9 and the menu
  725. will offer you the option to SHOW comments.  When comments are
  726. showing, the menu will offer you the option to HIDE the comments.
  727.  
  728. OUTPUT SELECTIONS
  729.  
  730. You can print a given list of entries or you can write an ASCII
  731. file to the default drive.  To set the system default options for
  732. your printer select Options from the Main Menu (see System Default
  733. Options, page 21).  To execute an output function, press F9 to get
  734. the List Menu shown on page 17.  
  735. PRINT SELECTION
  736.  
  737. Place the cursor on Print Selection and hit <ENTER>.  This option
  738. will give you a normal print of all of the entries for which you
  739. have selected the list,.e.g., Files, Volumes, or Libraries.  If
  740. comments are to be printed, they will print beneath the entry to
  741. which they apply.
  742.  
  743. CONDENSE PRINT
  744.  
  745. When you select Condense Print, CUDM will print two entries per
  746. line when comments are not printed.  When comments are to be
  747. printed, it will print an entry with its comment on the same line. 
  748. Both lists use the condensed print feature of your Epson-compatible
  749. printer.
  750.  
  751. DISKETTE COVER
  752.  
  753. This selection is applicable only to a Volume List.  It allows you
  754. to print a diskette cover that lists all files on the volume.  The
  755. diskette cover will fit inside the sleeve of a 5 1/4" diskette.
  756.  
  757. LABELS
  758.  
  759. This selection is applicable only to a Volume List.  It allows you
  760. to print the names of files contained on the volume to one or more
  761. one-up labels.  The first label contains the volume name, the
  762. number of DOS files on the volume (not the expanded file count),
  763. the available space on the volume, and up to 40 file names.  Any
  764. additional labels will contain up to 70 file names.  Information
  765. is printed using the condensed print feature of your Epson-
  766. compatible printer.  The following menu is provided to select from:
  767.  
  768.    *************************
  769.    * 1.5" X 4"             *
  770.    * 5.25" 1.5" X 4.75"    *
  771.    * 3.5"  2.75" X 2.75"   *
  772.    * Enhance Header - No   *
  773.    *************************
  774.  
  775. -  1.5" X 4"      -    This label is the most common size available
  776. for 5.25" diskettes.
  777.  
  778. -  5.25" 1.5" X 4.75"  This is the new Avery label (#4240) designed
  779. for 5.25" diskettes.
  780.  
  781. -  3.5"  2.75" X 2.75" This is the Avery label (#4241) designed for
  782. 3.5" diskettes.
  783.  
  784. - Enhance Header      If the feature is turned ON, the Volume and
  785. Catalog   Name will be printed full size while the remainder of
  786. the label will be extremely small.  Only 35 filenames will be
  787. placed on the first label.
  788. EXPORT SELECTION
  789.  
  790. When you choose the Export Selection, CUDM writes the current entry
  791. list in ASCII format to the drive and directory from which you are
  792. executing.
  793.  
  794. SYSTEM DEFAULT OPTIONS
  795.  
  796. The System Default Options, selected from the Main Menu (Options)
  797. allow you to: 
  798.      o  change the colors used on any of the CUDM screens,
  799.      o  set a beep to occur when menus appear and disappear,  o 
  800. set upper and lower case letter sensitivity,
  801.      o  establish sort sequences for your catalog lists,
  802.      o  save your printer and color settings for follow-on
  803. sessions.
  804.  
  805.  When you select Options, you will get the following Options Menu:
  806.  
  807.    ************************************
  808.    *  Colors                          *
  809.    *  Beep   - Off                    *
  810.    *  Upper/Lower Case (Upper Case)   *
  811.    *  Save Configuration              *
  812.    *  File Sort                       *
  813.    *  Library Sort                    *
  814.    *  Volume Sort                     *
  815.    ************************************
  816. COLORS
  817.  
  818. This feature allows you to change the colors that CUDM uses for its
  819. menus and windows.  When you select Colors, you will get the
  820. following Color Menu:
  821.  
  822.    ************************
  823.    *  Main Menu           *
  824.    *  Status Window       *
  825.    *  Alert Window        *
  826.    *  Request Window      *
  827.    *  List Window         *
  828.    *  List Submenu        *
  829.    *  Directory Window    *
  830.    *  Color Menu          *
  831.    *  Help Window         *
  832.    *  Set Default Colors  *
  833.    *  Set Monochrome      *
  834.    ************************
  835.  
  836. This is a list of all the different menus and windows used by CUDM. 
  837. The Main Menu and the Status Window shown on page 8.  The Alert
  838. Window appears when CUDM is saving your changes.  The Request
  839. Window prompts you to enter data.  The windows shown under
  840. ADD/UPDATE CATALOG ENTRIES (page 13) are Request Windows.  The List
  841. Window is the actual catalog entry listing.  The List Sub-Menu is
  842. shown on page 17.  The Directory Window results when you display
  843. a DOS directory, as discussed on page 25.  The Color Window is
  844. shown above.  The Help Window shows the help instructions discussed
  845. on page 25.  Set Default Colors allows you to reset the colors to
  846. the original CUDM settings, and Set Monochrome allows you to adjust
  847. settings for monochrome monitors.
  848.  
  849. Since each window or menu is different, each may have a different
  850. subset of components for which you can change the color.  Each of
  851. the possible components is described below.
  852.  
  853. Frame   -    This is the outline surrounding a menu or window.
  854.  
  855. Header  -    This is the title or heading found at the top of a
  856. menu or window.
  857.  
  858. Body    -    This is the remainder of the window or menu,  
  859. including the background and the text.
  860.  
  861. Statistics     -    These are the statistics or numbers that appear
  862. and change on the Status Window.  The headers that define the
  863. statistics are considered part of the Body.  
  864.  
  865. Selected Text  -    This is the line of text on which the cursor
  866. is resting.  It includes the text and the background.
  867. Hilight -    Each selectable menu item will have one letter that
  868. is highlighted (often the first letter).  That letter can be
  869. entered to select the item in lieu of placing the cursor on the
  870. item.
  871.  
  872. Help    -    This is the descriptor that appears in the upper  
  873. left corner of the Status Screen.  
  874.  
  875. Disabled       -    This is any menu item that you cannot select
  876. because it is not applicable to the operation at hand.
  877.  
  878. Shadow  -    This is a background shadow used to emphasize a help
  879. window.
  880.  
  881. Deleted Entry  -    This is found on the List Menus and is an entry
  882. that you have deleted from a catalog list.  This entry is not
  883. selected by the cursor.
  884.  
  885. Selctd-Deleted -    This is found on the List Menus and is an entry
  886. that you have deleted from a catalog list and the cursor is resting
  887. on the specific entry.
  888.  
  889. When you select the List Window from the Color Menu shown above,
  890. you will then be given the List Menu, as shown on page 14 (less
  891. Parameters).  You must then choose which type of List Window you
  892. wish to change.  Then, as with all other Color Menu choices, you
  893. will be given the Color Window.
  894.  
  895. COLOR WINDOW
  896.  
  897. The Color Window will appear on the screen to the left of the Color
  898. Menu and reflects the color scheme for the particular menu or
  899. window that you have chosen.  For example, if the body of the
  900. chosen menu is black letters on a gray background with a red frame,
  901. the Color Window will show the word "Body" in black on a gray color
  902. strip.  The word "Frame" would be in red on a gray color strip. 
  903. The default color selection in the Main Menu for Selected Text is
  904. yellow letters on blue background.  
  905.  
  906. The Color Window shows all the components of the particular window
  907. or menu that can be changed.  To change the background color strip,
  908. press the PgUp or PgDn key.  To change the color of the component,
  909. press the Home or End key.  When you have completed your color
  910. selections, hit <ENTER>.  Then call up the window or menu to see
  911. how it looks.
  912.  
  913. Several of the windows and menus include the Help component, which
  914. is the descriptor in the upper left corner of the Status Screen. 
  915. The Status Screen is visible when many of the windows or the menus
  916. are on the screen.  However, if you set the Help component of
  917. another window or menu to colors other than those set for the
  918. Status Screen, the Help Component will change when you initiate
  919. that particular window or menu.
  920. BEEP
  921.  
  922. When this feature is ON, your computer will beep when pull-down
  923. menus/windows appear and disappear.  When the feature is OFF, all
  924. is quiet.
  925.  
  926. UPPER/LOWER CASE
  927.  
  928. This feature allows you to specify whether or not you want CUDM to
  929. be sensitive to upper and lower case letters.  If the setting is
  930. Upper/Lower Case, CUDM will be sensitive to and show upper and
  931. lower case letters when used in volume, library, and file names. 
  932. If the setting is Upper Case, all names will be shown in upper case
  933. letters.
  934.  
  935. SAVE CONFIGURATION
  936.  
  937. This allows you to save any color changes that you make.  If you
  938. are using the CUDM default color selections, you will not be able
  939. to select this item.  When you change those colors, you must select
  940. this item if you want them saved for subsequent sessions.
  941.  
  942. SORTS
  943.  
  944. You can establish the main sort field for each of the catalog lists
  945. - File, Library, and Volume.  Select the type list for which you
  946. want to set the sort order (the default is the entry name).  You
  947. will be given a menu which lists the fields that show on the
  948. particular list.  The fields may include the Volume Name,
  949. Library/Ext, Filename, Extension, Size, and Date.  Place the cursor
  950. on the field that you want the list to be sorted on and press
  951. <ENTER>.  The list will then be sorted in ascending order on that
  952. field.
  953. UTILITIES
  954.  
  955. When you select Utilities, you are given the following options:
  956.  
  957.    ********************
  958.    *  DOS Shell       *
  959.    *  Erase Catalog   *
  960.    ********************
  961.  
  962. DOS SHELL
  963.  
  964. This allows you to make a temporary exit to DOS while CUDM is
  965. executing.  Simply place the cursor on DOS Shell and press ENTER. 
  966. To return to CUDM from DOS,  enter EXIT.
  967.  
  968. ERASE CATALOG
  969.  
  970. This allows you to erase the entire contents of your master
  971. catalog.  The catalog name will remain intact.  If you want to
  972. erase all reference to the catalog, you must exit CUDM and use the
  973. DOS ERASE command to erase all files related to catalogfile (the
  974. name that you assigned to the catalog).
  975.  
  976. DISPLAYING DOS DIRECTORIES
  977.  
  978. This allows you to view your DOS directories while running CUDM. 
  979. To accomplish this, select Directory from the Main Menu.  You will
  980. then be prompted to:
  981.  
  982.    ***************************
  983.    *  Enter a filename mask  *
  984.    ***************************
  985.  
  986. If you press <ENTER> without entering a mask, you will get a
  987. directory listing for the drive and directory on which you are
  988. executing.  You can place the cursor on any listed <dir>, and CUDM
  989. will then show you a listing of that directory.  If you wish, you
  990. can enter the name of a specific directory (e.g., \pathname), or
  991. you can enter a wild card parameter (e.g., *.da?).  
  992.  
  993. HELP 
  994.  
  995. The CUDM system has two help systems builtin. The one accessed from
  996. the main menu is called the extended help system and is essentially
  997. this document converted to an indexed disk file.  The second is a
  998. context-sensitive help system which is accessed by using the <F1>
  999. key from anywhere in the system.  It will provide you with a brief
  1000. tutorial of options available to you at that point in time.  The
  1001. context-sensitive help system is not designed to replace this
  1002. documentation but to provide a quick interactive memory jog.     
  1003. QUIT  
  1004.   
  1005. This menu option does just what it says. It terminates the program
  1006. and  returns to DOS. 
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.     Thank you for using Colorado Utilities Disk Manager.
  1015. (Meca)   Ordering Information  
  1016. Date:_____________  
  1017.  
  1018. Name:__________________________ Company:________________________
  1019.  
  1020. Address:_______________________ Title:__________________________
  1021.  
  1022. City:______________________ State:________ Zip:___________
  1023.  
  1024. Telephone:_____________________ Home( )  Office ( )  
  1025.  
  1026.  **************************************************************** 
  1027.    PRODUCT           PRICE         
  1028.   
  1029. Colorado Utilities Diskette Manager
  1030. Regular Memory Ver 3.1  (CUDM)
  1031.      registration only                       $ 20.00 ________
  1032.          
  1033.      registration plus
  1034.      printed manual, telephone support,
  1035.      one free product upgrade                $ 37.00 ________
  1036.  
  1037. Virtual Memory Ver 3.1  (CUVM)
  1038.      registration only                       $ 40.00 ________
  1039.   
  1040.      registration plus
  1041.      printed manual, telephone support,
  1042.      one year free upgrades                  $ 57.00 ________
  1043.  
  1044.  Shipping and Handling add: (per order)      $  5.00 ________
  1045.  
  1046.  For overseas shipment add: (per order)      $  3.00 ________
  1047.  
  1048.  Colorado customers add 3% state sales tax and 
  1049.      appropriate local tax:                          ________ 
  1050.  
  1051.                               Order Total:         $ ________    
  1052.  
  1053. Specify diskette format   5.25"___  or 3.5"___ (check one)  
  1054.   
  1055. Send to:                      (cricle one)
  1056.    Micro System Solutions     VISA or MASTERCARD ACCEPTED:
  1057.    5417 S. Cimarron Rd.
  1058.    Littleton, CO 80123        Card No. __________________________
  1059.                               Expiration Date:____/____
  1060.                          Authorized
  1061.                          Signature:________________________________
  1062.